home *** CD-ROM | disk | FTP | other *** search
/ Light ROM 1 / LIGHT-ROM 1 (Amiga Library Services)(1994).iso / ffdisks / d999.lha / QuadraComp / QCManual2.0.TXT < prev    next >
Text File  |  1994-04-05  |  47KB  |  1,300 lines

  1.  
  2.                            QuadraComposer 2.03
  3.  
  4.                  Copyright © 1993 Technological ArtWork
  5.                       (Bo Lincoln & Calle Englund)
  6.  
  7.  
  8.                           U S E R   M A N U A L
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19. DISTRIBUTION:
  20.     You are hereby given permission to distribute the
  21.     QC20.LhA archive (or the same decrunched), as long as it is 
  22.     redistributed in its original unmodified form. You may NOT take any fee 
  23.     for the program itself, only the costs for the media itself.
  24.  
  25.     Files included in this package:
  26.     * QuadraComposer2.0                      --- The program
  27.     * QCManual2.0.TXT                        --- This file
  28.     * QCManual2.0.guide                      --- The AmigaGuide® manual
  29.     * InstallQC2.0                           --- The Installer script
  30.     * QCReplay.s                             --- An ASM source
  31.     * QCFastReplay.s                         --- An ASM source
  32.     * QC.font sizes 6 & 8                    --- The font
  33.     + icons
  34.  
  35. SHAREWARE:
  36.     QuadraComposer is SHAREWARE, and if you use it you should pay the
  37.     shareware fee of US$ 20 (or the equal amount is SEK) (The fee
  38.     should be cashable in OUR local banks, so a $20-bill is the most
  39.     practical payment...). Please support us.
  40.     SWEDEN ONLY: Du kan betala på Bo Lincolns postgiro 920 74 13-7 
  41.     (repeat 920 74 13-7).
  42.  
  43. COPYRIGHTS:
  44.     QuadraComposer is Copyright © 1993 Technological Artwork (Bosse Lincoln
  45.     & Calle Englund).
  46.     QC makes use of reqtools.library for the requesters.
  47.     ReqTools is Copyright © Nico François.
  48.     Amiga is a registered trademark of Commodore-Amiga Inc.
  49.  
  50. THE AUTHORS:
  51.     * Bo Lincoln *
  52.  
  53.     SnailMail:  Bo Lincoln
  54.                 Ryttargatan 70
  55.                 S-731 52 KÖPING
  56.                 SWEDEN
  57.  
  58.     * Calle Englund *
  59.     Email:      c92caren@und.ida.liu.se
  60.  
  61.  
  62.  
  63.                             C O N T E N T S:
  64.  
  65.  
  66. 1 OPERATION OF QUADRA COMPOSER
  67.      1.0 SPECIAL GADGETS
  68.           1.0.1 UP / DOWN GADGET
  69.           1.0.2 CYCLE GADGET
  70.           1.0.3 LITTLE RED DOTS
  71.      1.1 WINDOWS
  72.           1.1.1 MENU WINDOW
  73.           1.1.2 MAIN NOTE WINDOW
  74.           1.1.3 SAMPLE WINDOW
  75.           1.1.4 SAMPLE EDIT WINDOW
  76.           1.1.5 DISK OPERATION WINDOW
  77.           1.1.6 MIXER WINDOW
  78.           1.1.7 TEXT WINDOW
  79.           1.1.8 NOTE EDIT WINDOW
  80.           1.1.9 SPECTRUM ANALYSER WINDOW
  81.           1.1.10 QUADRASCOPE WINDOW
  82.           1.1.11 PREFERENCES WINDOW
  83.      1.2 KEYBOARD COMMANDS
  84.  
  85. 2 HOW TO MAKE MUSIC WITH QUADRA COMPOSER
  86.      2.0 BASICS
  87.           2.0.1 NOTES
  88.           2.0.2 SAMPLE NUMBER
  89.           2.0.3 PATTERNS & POSITIONS
  90.      2.1 EFFECT COMMANDS
  91.           2.1.1 ARPEGGIO
  92.           2.1.2 PITCH SLIDE, UP
  93.           2.1.3 PITCH SLIDE, DOWN
  94.           2.1.4 TONE PORTAMENTO
  95.           2.1.5 VIBRATO
  96.           2.1.6 VOLUME SLIDE + SUSTAINED TONE PORTAMENTO
  97.           2.1.7 VOLUME SLIDE + SUSTAINED VIBRATO
  98.           2.1.8 TREMOLO
  99.           2.1.9 NOT USED (Why does it have a chapter?)
  100.           2.1.10 SET SAMPLE OFFSET
  101.           2.1.11 VOLUME SLIDE
  102.           2.1.12 POSITION JUMP
  103.           2.1.13 SET VOLUME
  104.           2.1.14 PATTERN BREAK
  105.           2.1.15 EXTENDED (E-) COMMANDS (see 2.1.17)
  106.           2.1.16 SET SPEED / TEMPO
  107.           2.1.17 EXTENDED COMMANDS
  108.                2.1.17.1 SET FILTER
  109.                2.1.17.2 FINE PITCHSLIDE, UP
  110.                2.1.17.2 FINE PITCHSLIDE, DOWN
  111.                2.1.17.2 SET GLISSANDO
  112.                2.1.17.2 SET VIBRATO WAVEFORM
  113.                2.1.17.2 SET FINETUNE VALUE
  114.                2.1.17.2 PATTERN LOOP
  115.                2.1.17.2 SET TREMOLO WAVEFORM
  116.                2.1.17.2 NOT USED
  117.                2.1.17.2 RETRIG NOTE
  118.                2.1.17.2 FINE VOLUMESLIDE, UP
  119.                2.1.17.2 FINE VOLUMESLIDE, DOWN
  120.                2.1.17.2 NOTECUT
  121.                2.1.17.2 NOTE DELAY
  122.                2.1.17.2 NOT USED
  123.                2.1.17.2 PATTERN DELAY
  124.           2.1.18 EFFECTS THAT DIFFER FROM THE NT-FORMAT
  125.  
  126. APPENDIX A  IFF EMOD FILE FORMAT
  127. APPENDIX B  HISTORY
  128.  
  129. 1 OPERATION OF QUADRA COMPOSER
  130. ==============================
  131. This chapter describes how to use Quadra Composer.
  132. First, some strange words will be explained.
  133.  
  134. Hexadecimal: All numbers, EXCEPT for percent numbers, are in 
  135. hexadecimal. Hexadecimal?, you ask. Calm down, it will be explained. 
  136. Our normal number system has the base 10; The first place has the 
  137. value 1, the second 10, the third 100, and so on. E.g:
  138.  
  139.            236
  140.      2*100///
  141.      3*10_//
  142.      6*1__/
  143.      = dec 236
  144.  
  145.      In hexadecimal, the base is dec 16:
  146.  
  147.            3A4
  148.      2*256///
  149.      10*16//    <--- Those numbers showed in decimal.
  150.      4*1__/
  151.      = dec 676
  152.  
  153. But then there must be 16 numbers!? Right, but since we only 
  154. have our normal 10, you use A, B, C, D, E and F as 10, 11, 12, 13, 14 
  155. and 15. If you want to type dec (decimal, base 10) 11 in hex, it will 
  156. be B. Simple. The reason of using this strange (?) system is that it 
  157. takes less space; With just two digits you can write numbers up to hex FF 
  158. (dec 255), not only up to dec 99.
  159.  
  160. RMB: Short for Right Mouse Button.
  161. LMB: Short for Left Mouse Button.
  162.  
  163.  
  164. 1.0 SPECIAL GADGET TYPES
  165. ========================
  166. These are the special gadgets used in Quadra Composer...
  167.  
  168. 1.0.1 UP/DOWN GADGET
  169. ====================
  170.     +--+
  171.     | /|
  172.     |/ |
  173.     +--+
  174.  
  175. Pressing the LMB over the up/down-wards pointing triangle will
  176. in/de-crease the value in the recessed box beside. If the RMB is
  177. pressed simultaneously, the rate of change will increase.
  178. All values are displayed in hexadecimal, except for the percentage values
  179. (otherwise it would be a bit confusing).
  180.  
  181. 1.0.2 CYCLE GADGET
  182. ==================
  183.     +---+
  184.     |/->|
  185.     ||  |
  186.     |\-/|
  187.     +---+
  188.  
  189. Cycles through multiple choices then clicked on with LMB. Pressing shift
  190. while clicking will make the cycle go backwards.
  191.  
  192.  
  193. 1.0.3 LITTLE RED DOTS
  194. =====================
  195. If a gadget has a little red dot in its upper right corner, then
  196. there is an option window attached to it. Clicking RMB brings it up.
  197.  
  198.  
  199. 1.1 WINDOWS
  200. ===========
  201. Quadra Composer 2.0 is built up using Intuition windows. Each part of the
  202. program has its own window.
  203.  
  204.  
  205. 1.1.1 MENU WINDOW
  206. =================
  207. This is the only window that must be open all the time. From this you can
  208. open the other windows. In this window are also the module control gadgets.
  209.  
  210.      +--+--+
  211.      | 1| 2|
  212.      +--+--+
  213.      | 3| 4|
  214.      +--+--+
  215.      | 5| 6|
  216.      +--+--+
  217.      | 7| 8|
  218.      +--+--+
  219.      | 9|10|
  220.      +--+--+
  221.      +--+--+
  222.      |11|12|
  223.      +--+--+
  224.      |13|14|
  225.      +--+--+
  226.      |15|16|
  227.      +--+--+
  228.  
  229.   1) Opens the main note window.
  230.   2) Opens the sample window.
  231.   3) Opens the disk operation window.
  232.   4) Opens the mixer window.
  233.   5) Opens the text display window.
  234.   6) Opens the note edit window.
  235.   7) Opens the spectrum analyzer window.
  236.   8) Opens the scope window.
  237.   9) Opens the preferences window.
  238.  10) Displays the About requester.
  239.  
  240.  11) Plays the module from the current position.
  241.  12) Plays the current pattern.
  242.  13) Starts recording.
  243.  14) Starts recording the current pattern.
  244.  15) Stops the music, turns the sound off and turns edit off.
  245.  16) Turns edit on.
  246.  
  247. When you press the CLOSE gadget in the upper left corner, the whole program
  248. will be ended.
  249.  
  250.  
  251. 1.1.2 MAIN NOTE WINDOW
  252. ======================
  253. This is the main window of Quadra Composer. It displays the current
  254. pattern, and it contains most gadgets for note editing.
  255.  
  256.      +------------------------------------------------+
  257.      |          On      On   1    On       On         |
  258.      +-----+------------------------------------+-----+
  259.      |   3 |                                    |  12 |
  260.      |   4 |                                    |  13 |
  261.      |   5 |                                    |  14 |
  262.      |   6 |                                    |  15 |
  263.      |   7 |                                    |  16 |
  264.      |   8 |                 2                  |  17 |
  265.      |   9 |                                    |  18 |
  266.      |  10 |                                    |  19 |
  267.      |     |                                    |  20 |
  268.      |     |                                    |  21 |
  269.      |  11 |                                    |     |
  270.      +-----+------------------------------------+-----+
  271.  
  272.   1) The window dragbar. It displays four On/Off's, which informs you about
  273.      the voice status.
  274.  
  275.   2) The pattern display. This is the place where you edit the patterns, by
  276.      using the keyboard. To edit the notes you must be in edit mode (press
  277.      [space]). When you go into edit mode the cursor turns red (unshaded). To
  278.      move around in the pattern, use the arrowkeys (NOT on the numeric
  279.      keyboard). You can mark notes by dragging the mouse.
  280.  
  281.   3) Pos. (Position) gadget. Use this to cycle trough the positions.
  282.  
  283.   4) Patt. (Pattern) gadget. This is the pattern attached to the current
  284.      position. You can change this to "mix" the patterns together to a song.
  285.      But, it's better to use the mixer (see mixer window) instead to put your
  286.      song together.
  287.  
  288.   5) C.patt. (Current Pattern) gadget. This gadget is used for changing the
  289.      current displayed pattern, i.e NOT the pattern attached to a position.
  290.  
  291.   6) Pattl. (Pattern Length) gadget. Use this gadget to change the length
  292.      of the current pattern. The length may vary from 1 to 256 lines, but the
  293.      value displayed is the number of the last line (number of lines - 1).
  294.  
  295.   7) Sample gadget. This gadget is actually duplicated, it can also be
  296.      found in the sample edit window. Use this gadget to change the current
  297.      sample number. You can use up to 255 samples (number zero cannot be used).
  298.  
  299.   8) Tempo gadget. This gadget sets the BPM (beats per minute) rate. The
  300.      tempo may vary from 32 to 255 (hex 20 to FF) BPM. Normally this rate is
  301.      set to 125 (hex 7D).
  302.  
  303.   9) Timing gadget. Toggles between CIA (CI) and vertical blank (VB)
  304.      timing. Normally you should use the CIA timing, because you can only
  305.      change tempo in this mode. The vertical blank timing is mostly used by 
  306.      demo coders, who don't want to waste the level 6 irq on music. If you
  307.      use the vertical blank timing in the USA the speed go up 20% (because
  308.      of NTSC).
  309.  
  310.  10) Songl (Song Length) gadget. Decides how many positions will be used.
  311.  
  312.  11) Cut & Paste gadgets. Use these to cut, copy, paste and clear the
  313.      marked block of the pattern.
  314.  
  315.  12) E.skip (Edit Skip) gadget. Sets the number of rows to jump down after
  316.      typing a note.
  317.  
  318.  13) Quant. (Quantisizing) gadget. Quantisizing lets you set if your notes
  319.      will be on every two rows, every three rows, and so on. Very useful if
  320.      you're recording e.g a drumbeat in realtime.
  321.  
  322.  14) Multi gadget. If you turn this on, the cursor will skip to another
  323.      track after typing a note.
  324.  
  325.  15-18) Multi 1-4 gadgets. Multi 1 sets where the cursor will skip after
  326.      typing a note in track 1, and so on.
  327.  
  328.  19) A.echo (Auto Echo) gadget. This sets whether the funny little effect
  329.      called Auto Echo will be on or off. Auto Echo makes a kind of echo after
  330.      each note typed, based on the default volume of the sample. 
  331.  
  332.  20) Ae.spec (Auto Echo Space) gadget. Sets the space between the echoes.
  333.  
  334.  21) Ae.cut (Auto Echo Cut) gadget. This is the percentage of volume cut
  335.      off the volume for each echo. When the volume reaches 4 or lower, the
  336.      echo stops.
  337.  
  338.  
  339. 1.1.3 SAMPLE WINDOW
  340. ===================
  341. Well, this is actually the biggest part of Quadra Composer (in bytes), so
  342. we hope that it will be useful. You don't actually have to use Quadra
  343. Composer as a music program, you can use it only as a sample edit program.
  344. The sample editor supports 16 bit editing, but you can still not load and
  345. save 16 bit sounds (sorry :-(). If you own a sample synth, and would like to 
  346. use Quadra Composer to edit the samples, please send us a reference for the
  347. sample and disk format, and we'll try to implement some 16 bit load and
  348. save functions.
  349.  
  350.      +-------------------------------+
  351.      |                               |
  352.      |                               |
  353.      |              1                |
  354.      |                               |
  355.      |                               |
  356.      |                               |
  357.      +-------------------------------+
  358.      |  2      7       13       18   |
  359.      |  3      8       14       19   |
  360.      |  4      9       15       20   |
  361.      |  5     10       16       21   |
  362.      |        11       17       22   |
  363.      |  6     12                23   |
  364.      +-------------------------------+
  365.  
  366.   1) The sample display. This is where the current sample, or a part of it,
  367.      is shown. You can mark the sample or a part of it by dragging the mouse.
  368.  
  369.   2) Period gadget. Sets the standard period, used by the "Play" gadgets,
  370.      and some effects.
  371.  
  372.   3) Volume gadget. Sets the standard volume of the current sample.
  373.  
  374.   4) F.tune (Finetune) gadget. Sets the finetune value of the current
  375.      sample.
  376.  
  377.   5) Loop gadget. Turns the loop of the current sample on / off.
  378.  
  379.   6) Cut & Paste gadgets. Cuts / copies / pastes / deletes the marked range
  380.      in the sample.
  381.  
  382.   7) Length gadget. Lengthens / shortens the sample.
  383.  
  384.   8) Play All gadget. Plays the whole sample.
  385.  
  386.   9) Play Display gadget. Plays the current display (most often the same
  387.      as the whole sample).
  388.  
  389.  10) Play Range gadget. Plays the range (if present).
  390.  
  391.  11) Show All gadget. Shows the whole sample.
  392.  
  393.  12) Show Range gadget. Zooms in so that only the present range will be
  394.      displayed.
  395.  
  396.  13) Sample gadget. This gadget can also be found in the main note window.
  397.      It changes the current sample number.
  398.  
  399.  14) Range All gadget. Sets the range to the whole sample.
  400.  
  401.  15) Zoom Out gadget. Shows 1/16 more of the sample (if possible).
  402.  
  403.  16) Copy Sample + Info gadget. Displays the copy sample window. If you
  404.      press copy in that window, the current sample + name + vol etc. will be
  405.      copied to the desired destination.
  406.  
  407.  17) Clear Sample + Info gadget. Clears the whole sample + name + vol etc.
  408.  
  409.  18) Backw. (Backwards) gadget. Reverses the sample or the range.
  410.  
  411.  19) Inverse gadget. Turns the sample up & down.
  412.  
  413.  20) Tone gadget. Plays a tone. This is used when tuning your sample. 
  414.      In the attached option window you can set the period and the voice of
  415.      the tone.
  416.   
  417.  21) Sample gadget. When pressing this gadget the computer will be frozen,
  418.      a window opened, and the sampler data will be heard in your speakers. In
  419.      the window the data will be displayed, so that you can adjust the input
  420.      volume. If you press RMB, the sample operation will be canceled. Otherwise
  421.      the program will start sampling as you press LMB, and continue until you
  422.      press LMB again, or until the sample is 128 kB (hex 1FFFE bytes) long.
  423.      In the option window you can turn Autostart on / off, set Autostart 
  424.      Sensibility, and turn Oversample on / off. Autostart will cause the
  425.      sampling operation to start immediately when a sound is heard (loud
  426.      enough). Oversample samples faster than the actual sample period, to get
  427.      rid of noise from the sampler.
  428.  
  429.  22) Edit gadget. Converts the current sample to 16 bit, and opens the
  430.      sample edit window. All disk operation is disabled. If you want to listen
  431.      to the sample the processor will be used to play it (since the Amiga can
  432.      only play 8 bit samples), which will cause the computer to freeze until 
  433.      you either press a mousebutton, or 'til the whole sound is played. 
  434.  
  435. 1.1.4 SAMPLE EDIT WINDOW
  436. ========================
  437. This is the window which contains all the fun parts of sample editing,
  438. the effects...
  439.  
  440.      +-----+-----+
  441.      |  1  |  9  |
  442.      |  2  | 10  |
  443.      |  3  |     |
  444.      |  4  | 11  |
  445.      |  5  | 12  |
  446.      |  6  | 13  |
  447.      |  7  | 14  |
  448.      |  8  | 15  |
  449.      +-----+-----+
  450.  
  451.   1) Tune gadget. Use this function to tune samples so that they fit
  452.      together. First, turn on the 'Tunetone'. Second, find the matching
  453.      period and finetune (by listening), and set the values in the Period 
  454.      and F.Tune gadgets. Third, if you want, you can set the desired Tune To
  455.      period in the Tuning Options window. Fourth, press the 'Tune' button.
  456.  
  457.   2) Volume gadget. Used to change the volume of the sample. 
  458.      In the window which appears, you can find the following gadgets:
  459.      The Startvolume is the start value, and it will slide over to Endvolume. 
  460.      Maximum is a function which scans the sample to find out how much the 
  461.      volume can be raised without cutoff. Norm sets the sliders to 100%. 
  462.      Out sets the Startvolume to 100%, and the Endvolume to 0%, to create a 
  463.      fade out. Guess what In is...
  464.      If range is present, the volumechange will only affect it.
  465.  
  466.   3) Mix gadget. This function will mix the current sample with the copy buffer 
  467.      (it doesn't matter if the copy buffer is 16 or 8 bit). The Startmix 
  468.      decides how much the mixed sample will be affected by the sample
  469.      and how much it will be affected by the copy buffer. E.g: If Startmix
  470.      is set to 75%, the current sample will have 75% of the volume, and the 
  471.      copy buffer 25%. Just like the Startvolume the Startmix will slide over 
  472.      to the Endmix.
  473.      If present, it will only affect the range.
  474.  
  475.   4) Oct. Up (Octave Up) gadget. Doubles the sample frequency.
  476.  
  477.   5) Oct. Down (Octave Down) gadget. Halves the sample frequency.
  478.  
  479.   6) Echo gadget. Creates an echo in the sample. Echo rate decides how fast 
  480.      the echo will return. Decay rate decides how fast the echo will vanish. 
  481.      If you turn on Re-Echo, each echo will return more than once. Echo 
  482.      and Reverb are presets, just like In and Out in the volume window.
  483.      If present, the range will be used as echo.
  484.      If you set the sample cursor while the echo window is open, the Echo
  485.      Rate will be adjusted so that the first echo will be on the sample cursor
  486.      position.
  487.  
  488.   7) Flange gadget. This function creates a "swirl" effect in the sample.
  489.      In the flange window you can set the depth and the frequency of the 
  490.      flange.
  491.  
  492.   8) OK gadget. Converts the 16 bit edit buffer to 8 bit, and replaces the
  493.      old 8 bit sample. Then it closes the edit windows.
  494.  
  495.   9) Chord gadget. This is a kind of Tune and Mix macro, which creates a 
  496.      chord. You can mix up to four notes to a chord. Major, Minor, Major
  497.      Sept., Sus2, Sus4 and Minor Sept. are presets, which builds a chord based 
  498.      on the first note.
  499.  
  500.  10) Synth gadget. This is a rather BIG function, which makes sounds by
  501.      adding sinewaves (additive synthesizer). In the window which appears you can
  502.      find the following gadgets:
  503.  
  504.      a) Cut Off Envelope. Lets you draw a freehand filter curve.
  505.      b) Volume Envelope. Lets you draw a freehand volume curve.
  506.      c) Pitch Envelope. Lets you draw a freehand pitch curve. Every pixel
  507.         is a half-tone, and the red lines represent "C".
  508.  
  509.      In all of the windows above, you can find something called LFO (Low
  510.      Frequency Oscillation). These adjust the envelopes by pulling 'em up and
  511.      down.  
  512.  
  513.      d) Resonance gadget. Lets you draw a freehand resonance curve. What
  514.         you actually do is to change the volumes of the different frequencies.     
  515.  
  516.      e) Phase gadget. Lets you draw a freehand phase distortion curve. The
  517.         curve is a kind of translation table for angles. E.g if it is a normal
  518.         corner to corner straight line, 10° will be 10° when the sound is made.
  519.         If you draw the line from the left-bottom corner to the middle of the 
  520.         right edge, 10° will actually be 5°.
  521.  
  522.      NEW FOR 2.03:
  523.  
  524.      f) Noise Envelope. Lets you draw a freehand noise curve.
  525.  
  526.      g) Load Envelopes. Asks for an IFF ENVL (Envelopes) file to load. This file
  527.         contains all of the data above.
  528.  
  529.      h) Save Envelopes. Saves your current envelopes etc. as an IFF ENVL file.
  530.  
  531.      The length of the sample will be decided by the Length gadget. The
  532.      length must be at least 256 (hex 100) bytes.
  533.  
  534.  11) Delta 1 Filter gadget. This is a relatively "soft" filter. Use it for 
  535.      "cutting the edge" of those "sharp" samples. Doesn't affect noise.
  536.      If present, only the range will be affected.
  537.  
  538.  12) Delta 2 Filter gadget. Displays a window with a Cut Frequency slider.
  539.      If you try to filter a low frequency, the sample will sound a bit
  540.      strange, because the filter also cuts all the multiples of the cut
  541.      frequency.
  542.      The Range gadget will set the the Cut Frequency so that a wave with
  543.      the same length as the range will be cut.
  544.      If the range is set while filtering, only the range will be affected.
  545.  
  546.  13) Boost 1 "Filter" gadget. Can make relatively "sharp" sound even worse...
  547.  
  548.  14) Boost 2 "Filter" gadget. This filter can actually "anti filter" samples,
  549.      i.e make the sound clearer. If you use it more, it makes the samples 
  550.      really "sharp".
  551.  
  552.  15) Cancel gadget. Forgets the 16 bit sample, and goes back to the old 8
  553.      bit sample.
  554.  
  555.  
  556. 1.1.5 DISK OPERATION WINDOW
  557. ===========================
  558. This is the menu which contains all the disk operation functions (load, save).
  559.  
  560.      +------+
  561.      |   1  |
  562.      |   2  |
  563.      |      |
  564.      |   3  |
  565.      |   4  |
  566.      |   5  |
  567.      |      |
  568.      |   6  |
  569.      |   7  |
  570.      |      |
  571.      |   8  |
  572.      |   9  |
  573.      |      |
  574.      |  10  |
  575.      |  11  |
  576.      |  12  |
  577.      |  13  |
  578.      |  14  |
  579.      +------+
  580.     
  581.   1) Load Module gadget. Displays a file requester, in which you should
  582.      pick the desired module. If you load a new module, the old one will be
  583.      lost. Quadra Composer 2.0 supports IFF EMOD and Noisetracker modules.
  584.  
  585.   2) Save Module gadget. Displays a requester asking which module format
  586.      you want to use. Default, and the best, choise is "IFF EMOD", which is an
  587.      extension of the other choice, "Noisetracker".
  588.  
  589.   3) Load Pattern From Module gadget. Lets you pick an IFF EMOD. The
  590.      patterns of the module will be displayed in a window. To load a pattern on
  591.      top of the current pattern (the length will be adjusted), just double
  592.      click on it.
  593.      In the option window, you can turn Load Samples on / off. Load Sample mean
  594.      that all the samples in the loaded pattern will be added to the module,
  595.      unless you don't already have a sample with the same name. This option
  596.      goes for Load Track From Module too.
  597.      A little tip: You can build up "clip" modules with e.g drumtracks, which
  598.      you later can include in your music.
  599.  
  600.   4) Load Track From Module gadget. See above.
  601.  
  602.   5) Load Sample From Module gadget. See above.
  603.  
  604.   6) Load Sample gadget. Loads a sample, IFF 8SVX or raw.
  605.  
  606.   7) Save Sample gadget. Lets you pick a file format, IFF 8SVX or raw, in
  607.      which the sample will be saved.
  608.  
  609.   8) Load Settings gadget. Loads your previously saved settings from the file
  610.      "s:QuadraComposer.prefs".
  611.  
  612.   9) Save Settings gadget. Saves your settings.
  613.  
  614.  10) Use Sample List gadget. Displays the sample list window. A sample list is
  615.      just a list in which names and paths of samples are. This is very useful
  616.      if you have loaded all your sample disks to the list. You can then easily
  617.      find THAT sample you're looking for. Another advantage is that you don't
  618.      have to wait for the computer to read the directory every time.
  619.      To load a sample from the list, just double click on it. If the disk
  620.      is not in your drives, the computer will ask for it as usual.
  621.  
  622.  11) Load Sample List gadget. Loads your previously saved sample list file
  623.      (s:QuadraComposer.samplelist). The sample list file is actually an ASCII
  624.      text, which you can edit from any text editor.
  625.  
  626.  12) Temporary Sample List gadget. Asks for a directory, which will be read
  627.      and used as a temporary sample list. This is used if you want to load 
  628.      more than one sample from a disk which is not in your sample list.
  629.  
  630.  13) Add Sample To List gadget. Displays a multiselect file requester, from
  631.      which you can choose one, or by pressing shift, more, samples to the
  632.      current sample list.
  633.  
  634.  14) Save Sample List gadget. Saves the current sample list to the file
  635.      s:QuadraComposer.samplelist.
  636.  
  637. 1.1.6 MIXER WINDOW
  638. ==================
  639. This window is used to mix your patterns together to a song.
  640.  
  641.      +-----------------------+-----+
  642.      |                       |     |
  643.      |                       |     |
  644.      |                       |     |
  645.      |                       |     |
  646.      |           1           |  2  |
  647.      |                       |     |
  648.      |                       |     |
  649.      |                       |     |
  650.      +-----------------------+-----+
  651.      | 3 4                   |     |
  652.      +-----------------------+-----+
  653.  
  654.   1) Pattern list display. Here are the 256 patterns plus numbers
  655.      listed. If you click on a pattern, it will be marked, and if you drag it,
  656.      you can insert the patternnumber in the position list.
  657.  
  658.   2) Position list display. Here are the <songlength> positions listed. Just
  659.      like the pattern list, you can mark positions, and move them around by
  660.      dragging with the mouse.
  661.  
  662.   3) Paste gadget. Inserts the marked pattern number in the position list,
  663.      at the marked position.
  664.  
  665.   4) Clear gadget. Deletes the marked position.
  666.  
  667.  
  668. 1.1.7 TEXT WINDOW
  669. =================
  670. This is just a tiny text window.
  671.  
  672.      +-------------------+
  673.      |         1         |
  674.      |         2         |
  675.      |         3         |
  676.      |         4         |
  677.      |         5         |
  678.      +-------------------+
  679.  
  680.   1) Song name gadget.
  681.   2) Copyright / composer name gadget.
  682.   3) Current sample name gadget.
  683.   4) Current pattern name gadget.
  684.   5) Status line.
  685.  
  686. 1.1.8 NOTE EDIT WINDOW
  687. ======================
  688. Here are some note and track editing functions.
  689.  
  690.      +-------------------+
  691.      |    1         3    |
  692.      |    2         4    |
  693.      |                   |
  694.      +-------------------+
  695.      |                   |
  696.      |         5         |
  697.      |                   |
  698.      |                   |
  699.      +-------------------+
  700.  
  701.   1) Expand Track gadget. This function doubles the space between notes in
  702.      the current track, starting from the current line.
  703.  
  704.   2) Swap Tracks gadget. Swaps the active track with another.
  705.  
  706.   3) Clear Track gadget. Clears the current track from the current line.
  707.  
  708.   4) Exg (Exchange) Sample In Track gadget. Replaces the current sample
  709.      number in the track with a new one.
  710.  
  711.   5) Transposing gadgets. These gadgets lets you transpose notes up or
  712.      down. Active sample means that only notes with the active sample number
  713.      will be affected.
  714.  
  715.  
  716. 1.1.9 SPECTRUM ANALYZER WINDOW
  717. ==============================
  718. This is a little window showing a spectrum analysis of the sounds being
  719. played. It works remarkably well, although it doesn't use FFT. If you size
  720. the window to maximum size, the spectrum analyser will change, and get
  721. bigger (and slower).
  722. When the analyser is small, each line represents 1/4 of an octave.
  723. Otherwise the each line represents 1 note.
  724.  
  725.  
  726. 1.1.10 QUADRASCOPE WINDOW
  727. =========================
  728. This is also a way of showing the samples being played. If the window is
  729. small, four "scopes" are being displayed, one for each voice. Otherwise
  730. only one, including all voices is displayed.
  731.  
  732.  
  733. 1.1.11 PREFERENCES WINDOW
  734. =========================
  735.  
  736.      +------------------------+
  737.      |   1            3       |
  738.      |   2            4       |
  739.      |                        |
  740.      |   5                    |
  741.      |                        |
  742.      | 6    7    8            |
  743.      +------------------------+
  744.  
  745.   1) Screen Mode gadget. Lets you pick a screen mode, minimum 640x256
  746.      pixels.
  747.  
  748.   2) Palette gadget. Lets you adjust the palette.
  749.  
  750.   3) Big Scope Accuracy slider. Sets how many pixels should be displayed
  751.      per voice in the big scope.
  752.  
  753.   4) Big Spectrum Accuracy. Sets how many frequencies the analyser should
  754.      try to find.
  755.  
  756.   5) Hex - Dec gadgets. This is a translator from hexadecimal to decimal
  757.      and decimal to hexadecimal. Just type the number in the gadget and press
  758.      <enter>.
  759.  
  760.   6) Fake Chipmem gadget. If this is on, Quadra Composer will try to use
  761.      the internal fast memory expansion on A500's as chipmem. This will not
  762.      work if you don't have ECS.
  763.  
  764.   7) RMB Activate gadget. If this is on, you'll be able to activate windows
  765.      with the right mouse button.
  766.  
  767.   8) Fast Graphics gadget. Fast graphics means that the window graphics is 
  768.      drawn by internal _fast_ functions in Quadra Composer. If it's off
  769.      graphics.library will be used. Note: If you have a graphics card, like
  770.      Merlin, Picasso, Retina etc. you _must_ turn this function off!
  771.  
  772. 1.2 KEYBOARD COMMANDS
  773. =====================
  774. Many of these commands can also be found in the menus, using Amiga standard
  775. (amiga + key).
  776. The main keyboard is used for entering notes.
  777. (Am. layout)
  778.      2 3   6 7 8   9
  779.     Q W R T Y U I O P       Higher octave
  780.     \___/
  781.         \_________ The same notes
  782.                   \___
  783.                   /   \
  784.      S D   G H J   L ;
  785.     Z X C V B N M , . /     Lower octave
  786.  
  787. The default lower octave is 2.
  788.  
  789. MISC KEYBOARD COMMANDS.
  790. =======================
  791. RIGHT SHIFT     Record song.
  792. RIGHT ALT       Play song.
  793. RIGHT AMIGA     Play pattern.
  794. <               Turn off all samples. (Not available on some Am.
  795.                                        keyboards.)
  796. SPACE           Toggle editing on/off.
  797. RETURN          Insert blank row in track.
  798. A-RETURN        Insert blank row in pattern (all tracks).
  799. C-RETURN        Insert blank row in track (effect cmd only).
  800. BACKSPACE       Delete previous row and move rest of the track upwards.
  801. A-BACKSP.                          -"-                   pattern  -"-
  802. C-BACKSP.       As BACKSPACE but only effect command.
  803. DELETE          Delete note/effect of the current track, row.
  804. S-DELETE        Delete note+effect        -"-
  805. TAB             Move cursor to next track (right).
  806. S-TAB                 -"-      prev  -"-   left
  807. F1              Set lower octave to "1"
  808. F2              Set lower octave to "2"
  809. F3              Cut block to buffer.
  810. S-F3            Cut entire track (notes only).
  811. A-F3            Cut entire pattern (notes only).
  812. F4              As F3, but Copy instead.
  813. F5              Paste buffer.
  814. S-F5            Paste from top of track (notes only).
  815. A-F5            Paste from "top left corner" of track (notes only).
  816. F6-F10          Move to "bookmark", default are 00/10/20/30/40
  817. S-(F6-F10)      Set "bookmark".
  818. A-(F6-F10)      Play pattern from "bookmark".
  819. C-(F6-F10)      Record        -"-
  820. S-(1-9)         Store current effectcommand in effectbuffer 1-9.
  821. A-(1-9)         Paste effectbuffer 1-9 into current cursorpos.
  822. C-(1-9)         Set editskip to 1-9. Ie the number of rows the editor
  823.                 jumps after a note is struck.
  824. A-(Z,X,C,V)     Toggle voice 1-4 on/off
  825. A-MINUS (Main keyboard, Am. layout)
  826.                 Copy previous effect command and decrease its
  827.                 argument.
  828. A-PLUS (Main keyboard, Am. layout)
  829.                 Copy prev. fx cmd and increase its arg.
  830. A-\             Copy prev. fx cmd.
  831.  
  832. C-A             Toggle current voice on/off.
  833. C-C             Copy block.
  834. C-D             Clear block.
  835. C-E             Expand track.
  836. C-F             Toggle filter on/off.
  837. C-G             Toggle AutoEcho on/off.
  838. C-I             Paste buffer.
  839. C-K             Clear to end of track.
  840. C-M             Toggle MultiMode on/off
  841. C-P             Paste buffer.
  842. C-Q             Turn all voices on.
  843. C-R             Restore "bookmarks".
  844. C-T             Swap tracks.
  845. C-V             Paste buffer.
  846. C-X             Cut block.
  847.  
  848. ARROW KEY OPERATION
  849. ===================
  850. UP              Move cursor up.
  851. DOWN            Move cursor down
  852. LEFT            Move cursor left.
  853. RIGHT           Move cursor right.
  854. S-UP            Move cursor up 8 rows.
  855. S-DOWN          Move cursor down 8 rows.
  856. S-LEFT          Decrease position.
  857. S-RIGHT         Increase position.
  858. C-LEFT          Decrease sample number.
  859. C-RIGHT         Increase sample number.
  860. A-LEFT          Decrease current pattern number.
  861. A-RIGHT         Increase current pattern number.
  862.  
  863. NUMERIC KEYPAD (Not available on A600. ;-(
  864. ==========================================
  865.  
  866. +-+-+-+-+
  867. |1|2|3|4|
  868. +-+-+-+-+
  869. |5|6|7|8|
  870. +-+-+-+-+
  871. |9|A|B|C|
  872. +-+-+-+-+
  873. |D|E|F|0|
  874. +-+-+-+ |
  875. |   | | |
  876. +---+-+-+
  877.  ^   ^
  878.  |   \_ Increase sample number by HEX 10.
  879.  \_____ Decrease         -"-
  880.  
  881.  
  882.  
  883. 2 HOW TO MAKE MUSIC USING QUADRA COMPOSER
  884. =========================================
  885. This is a chapter which describes how to make music. Those of you who
  886. have used NoiseTracker, or a clone, can skip this chapter, since Quadra
  887. Composer works the same way.
  888.  
  889. 2.0 BASICS
  890. ==========
  891. Quadra Composer works with four voices (limited by the Amiga), which
  892. are represented by the four tracks you can see in the main note window.
  893. These four tracks of a certain length form a pattern. Up to 256 patterns
  894. can form a song, and finally, a song plus all samples form a module.
  895.  
  896. 2.0.1 NOTES
  897. ===========
  898. The first space in every line of a track is reserved for the note.
  899.  
  900.      C#101000
  901.      \_/
  902.        \__ The note.
  903.  
  904. The note range is from C-1 (lowest) to B 3 (highest). Each time the track
  905. finds a note when playing, it will play the sample connected to it, using
  906. the note frequency. But, it's not like a synthesizier, since the sample will
  907. not stop when you release the key. In keeps playing until the entire sample
  908. is played, or until you play another sample in the sample voice. If you
  909. want to cut a sample before it's completely played, you'll have to use the
  910. volume effect command (see chapter 2.1).
  911.  
  912. 2.0.2 SAMPLE NUMBER
  913. ===================
  914. To each note there must be a sample number, so that Quadra Composer will
  915. know what sound to play.
  916.  
  917.      C#101000
  918.         \/
  919.          \__ The sample number.
  920.  
  921. The sample number will automatically be written when typing a note.
  922.  
  923. Using this little knowledge you can make your first modules. If you want to
  924. make the more advanced, check out the next chapter.
  925.  
  926. 2.0.3 PATTERNS & POSITIONS
  927. ==========================
  928. When you've made some patterns, you can mix 'em together to a song, either
  929. by using the Pos. and Patt. gadgets, or by using the mixer.
  930.  
  931. 2.1 EFFECT COMMANDS
  932. ===================
  933. The effect command is the last three (3) digits of each line of a
  934. track.
  935.  
  936. | C 101xyz |
  937.   ^^^^^^^^
  938.   \_/\/\_/____ Effect command
  939.     \ \_______ Sample number
  940.      \________ Note.
  941.  
  942. 2.1.1 Command 0yz: ARPEGGIO
  943. =========================
  944. Arpeggio is a rapid pitch change. The pitch changes between the
  945. played note and the notes Y resp. Z halftones higher.
  946.  
  947.  
  948. 2.1.2 Command 1yz: PITCH SLIDE, UP
  949. ================================
  950. Slides the pitch up YZ halftones. The resulting pitch cannot be
  951. higher than the highest possible pitch (B 3).
  952.  
  953.  
  954. 2.1.3 Command 2yz: PITCH SLIDE, DOWN
  955. ==================================
  956. Slides the pitch down YZ halftones. The resulting pitch cannot be
  957. lower than the lowest possible pitch (C 1).
  958.  
  959.  
  960. 2.1.4 Command 3yz: TONE PORTAMENTO
  961. ================================
  962. Slides the pitch up/down to played the note at YZ halftones per
  963. frame. The effect must be reactivated on each row. If YZ=00 then the
  964. last YZ will be used.
  965.  
  966. | C 101000 |
  967. | C 201302 |
  968. |    00300 |
  969. |    00300 |
  970. | ...      |
  971.  
  972. When the desired pitch is reached, the effect will not do anything.
  973.  
  974.  
  975. 2.1.5 Command 4yz: VIBRATO
  976. ========================
  977. Makes a vibrato effect on the sample played. The command must be
  978. reactivated on each row. Y is the speed of the vibrato and Z is the
  979. depth. If an argument is "0" then the previous value used will be
  980. used.
  981.  
  982. | C 101445 |        +-------------------------------------+
  983. |    00406 |     <--| Makes the vibrato deeper and deeper |
  984. |    00407 |        +-------------------------------------+
  985. |    00408 |
  986. |    00409 |
  987.  
  988.  
  989. 2.1.6 Command 5yz: VOLUME SLIDE + SUSTAINED TONE PORTAMENTO
  990. =========================================================
  991. Adds a volume slide to a tone portamento. The portamento must be
  992. initialized with the [3yz] effect before this effect can be used. The
  993. Y argument represents the volume increase rate and Z the decrease.
  994.  
  995. | C 101000 |        +--------------------------------------+
  996. | C 201305 |     <--| Continues the portamento and slides  |
  997. |    00501 |        | the volume down                      |
  998. |    00501 |        +--------------------------------------+
  999. |...       |
  1000.  
  1001.  
  1002. 2.1.7 Command 6yz: VOLUME SLIDE + SUSTAINED VIBRATO
  1003. =================================================
  1004. Similar to command [5yz], see above. The vibrato should be
  1005. initialized before using this command.
  1006.  
  1007.  
  1008. 2.1.8 Command 7yz: TREMOLO
  1009. ========================
  1010. Creates a volume vibrato. The speed is set with the argument Y and
  1011. the depth with Z. If an argument is "0" then the last value for that
  1012. argument is used.
  1013.  
  1014. 2.1.9 Command 8yz: NOT USED
  1015. =========================
  1016.  
  1017. 2.1.10 Command 9yz: SET SAMPLE OFFSET
  1018. ===================================
  1019. Used only when a note is played, to skip a bit into the sample. The
  1020. argument YZ is multiplied with hex 200 and that many bytes of the
  1021. sample are skipped.
  1022.  
  1023. | C 101923 |     <--| Skips hex 23 * 200 = 4600 bytes |
  1024.  
  1025. NOTE: This differs from the NT-format, where the offset was hex
  1026. YZ*100.
  1027.  
  1028. 2.1.11 Command Ayz: VOLUME SLIDE
  1029. ==============================
  1030. Slides the volume up at the speed set by Y or down at the speed set
  1031. by Z. The effect must be reactivated on each row.
  1032.  
  1033. | C 207A20 |        +-----------------------+
  1034. |    00A20 |     <--| Slides the volume up. |
  1035. | ...      |        +-----------------------+
  1036.  
  1037. 2.1.12 Command Byz: POSITION JUMP
  1038. ===============================
  1039. Skips the rest of the current pattern (It's a good idea to pull the
  1040. length down to save some bytes of memory...) and jumps to position
  1041. hex YZ.
  1042.  
  1043. NOTE: This differs from the NT-format, where the argument to this
  1044. effect was given as a decimal number.
  1045.  
  1046.  
  1047. 2.1.13 Command Cyz: SET VOLUME
  1048. ============================
  1049. Set the volume for a channel. The argument YZ sets the new volume.
  1050. The volume must be between hex 0 and 40.
  1051.  
  1052. 2.1.14 Command Dyz: PATTERN BREAK
  1053. ===============================
  1054. Skips the rest of the current pattern (see command Byz) and the first
  1055. YZ rows of the next pattern (YZ should not exceed the length of the
  1056. next pattern).
  1057.  
  1058. 2.1.15 Command Eyz: EXTENDED (E-)COMMANDS
  1059. =======================================
  1060. The e-commands are explained below.
  1061.  
  1062. 2.1.16 Command Fyz: SET SPEED/TEMPO
  1063. =================================
  1064. Sets the speed of a pattern (and the ones that follow...) if the
  1065. argument YZ is less than or equal to hex 1F or the tempo if YZ is
  1066. higher than hex 1F.
  1067.  
  1068. The speed is normally the number of picture frames or vertical blanks
  1069. (1/50 second PAL or 1/60 second NTSC) to wait between each row of a
  1070. pattern. The default speed is 06, ie 0.12 seconds (PAL) or 125 beats
  1071. per minute.
  1072.  
  1073. If the tempo is set QuadraComposer will switch from VBL timing (125
  1074. bpm, PAL) to CIA timing. The default tempo is hex 7D (125 bpm,
  1075. again). The tempo rating assumes a default speed setting.
  1076.  
  1077. TECHNOTE: If the tempo is set to anything else than 7D, then the
  1078. level 6 CIA interrupt must be used. If the tempo is set high then the
  1079. replay takes more time each frame (the replay interrupt also will get
  1080. out of phase with the screen refresh, so worst case time consumption
  1081. can get high (or at least unpredictable) even when using lower tempo,
  1082. check the replay routine...).
  1083.  
  1084.  
  1085. 2.1.17 EXTENDED COMMANDS
  1086. ======================
  1087.  
  1088. 2.1.17.1 Command E0z: SET FILTER
  1089. ==============================
  1090. Used to switch the internal audio filter on or off. If Z is "0" the
  1091. filter is switched on and if Z is "1" the filter is switched off.
  1092.  
  1093. NOTE: Some old amiga's don't have this feature.
  1094.  
  1095. 2.1.17.2 Command E1z: FINE PITCHSLIDE, UP
  1096. =======================================
  1097. Slide the pitch up a little bit, Z is simply added to the pitch.
  1098.  
  1099. 2.1.17.3 Command E2z: FINE PITCHSLIDE, DOWN
  1100. =========================================
  1101. As above, but down.
  1102.  
  1103. 2.1.17.4 Command E3z: SET GLISSANDO
  1104. =================================
  1105. Turn glissando on (Z = "1") or off (Z = "0"). Glissando is used with
  1106. portamento. If it is turned on, then the portamento will be done
  1107. halftone by halftone, like "walking" up or down the piano.
  1108.  
  1109. TECHNOTE: This effect can use up a lot of time, check the replay
  1110. routine...
  1111.  
  1112. 2.1.17.5 Command E4z: SET VIBRATO WAVEFORM
  1113. ========================================
  1114. Simply selects the waveform used for vibrato effects. Z=0     Use
  1115. sinewave (default) Z=1     Use ramp down Z=2     Use squarewave
  1116.  
  1117. 2.1.17.6 Command E5z: SET FINETUNE VALUE
  1118. ======================================
  1119. Sets the finetune value for a channel. The finetune can vary from -8
  1120. to 7 (using 2's complement, ie 0 to 7 are represented by the numbers
  1121. 0 to 7, and -8 to -1 are represented by the numbers 8 to F).
  1122.  
  1123. | C 101E5E |     <--| Set the finetune value to -2 |
  1124.  
  1125. 2.1.17.7 Command E6z: PATTERN LOOP
  1126. ================================
  1127. Used for creating loops in patterns. First the first row of the loop
  1128. must be defined, by using Z = 0, and then at the end of the loop, the
  1129. number of "jump backs" are defined with Z > 0. Nested loops (inside
  1130. each other) are not possible.
  1131.  
  1132. | C 303E60 |     <--| Beginning of the loop |
  1133. | ...      |
  1134. |    00E64 |     <--| The loop will be replayed 4 times, then |
  1135.                     | continue                                |
  1136.  
  1137. 2.1.17.8 Command E7z: SET TREMOLO WAVEFORM
  1138. ========================================
  1139. Like command E4z, but sets waveform for tremolo instead.
  1140.  
  1141. 2.1.17.9 Command E8z: NOT USED
  1142. ============================
  1143.  
  1144. 2.1.17.10 Command E9z: RETRIG NOTE
  1145. ================================
  1146. Plays the note every Z VBL's (see effect Fyz). Useful is you want to
  1147. play the pattern slowly, but want say, a hihat playing rapidly.
  1148.  
  1149. 2.1.17.11 Command EAz: FINE VOLUMESLIDE, UP
  1150. =========================================
  1151. Simply adds the argument to the current volume of the channel.
  1152.  
  1153. 2.1.17.12 Command EBz: FINE VOLUMESLIDE, DOWN
  1154. ===========================================
  1155. Simply subtracts the argument from the current volume.
  1156.  
  1157. 2.1.17.13 Command ECz: NOTECUT
  1158. ============================
  1159. Cuts the note after Z VBL's (see effect E9z), ie sets the volume to
  1160. 00.
  1161.  
  1162. 2.1.17.14 Command EDz: NOTE DELAY
  1163. ===============================
  1164. Waits Z VBL's, before playing the note.
  1165.  
  1166. 2.1.17.15 Command EEz: NOT USED
  1167. =============================
  1168.  
  1169. 2.1.17.16 Command EFz: PATTERN DELAY
  1170. ==================================
  1171. Delays the pattern Z VBL's. Useful for creating a short pause in the
  1172. music.
  1173.  
  1174.  
  1175. 2.1.18 EFFECTS THAT DIFFER FROM THE NT-FORMAT
  1176. ===========================================
  1177. Some effects differ slightly from the nt-format. These are effect
  1178. 9yz, 4yz (new for 2.03), and effect Byz. These differences are autimagically converted
  1179. when a module is loaded/saved in NT-format.
  1180.  
  1181.  
  1182. APPENDIX A  IFF EMOD FILE FORMAT
  1183. ================================
  1184. The standard EMOD fileformat is using the standard IFF (not 
  1185. SMUS!) format. It was necessary to create a new fileformat, to be able 
  1186. to include all the new features (compared to the NT-fileformat), like:
  1187.  
  1188.      * 255x128 kb samples.
  1189.  
  1190.      * 256x256 rows named patterns.
  1191.  
  1192.      * 255 positions.
  1193.  
  1194.      * Better internal format for pattern data - 4 bits left per note 
  1195.       for future expansion.
  1196.  
  1197.  
  1198. The patterndata is put in the file row by row, 4 bytes for each 
  1199. note, and 16 bytes for each row:
  1200.  
  1201. SampleNr NoteNr   Empty Effect 
  1202.                         cmd.
  1203. -------- -------- ----  -------------
  1204. 00000000 00000000 0000  0000-00000000        <--- Bits
  1205. -------- -------- ---------- --------  
  1206. Byte 0   Byte 1   Byte 2     Byte 3    
  1207.  
  1208. The notenumber is a number from 0 to 35 which corresponds to a 
  1209. note (C 1 to B 3). To get the period you'll have to use a list. The following 
  1210. are  the IFF chunks of the EMOD fileformat. If you want to add something 
  1211. new to the module like a long comment or a text, please make a new 
  1212. chunk. A properly made program should just ignore the unknown chunks.
  1213.  
  1214.  
  1215. Type      Size Description
  1216. ~~~~~~~~~~~~~~~~~~~~~~~~~~
  1217. char         4    "FORM"
  1218. long         4    Size of file from offset 8
  1219.  
  1220. *********** Infochunk ************
  1221.  
  1222. char      4    "EMOD"                ;Extended Module
  1223. char      4    "EMIC"                ;Extended Module Info Chunk
  1224. long      4    Size of chunk
  1225. word      2    Version of IFF EMIC-chunk
  1226. char      20   Name of song
  1227. char      20   Composer
  1228. byte      1    Tempo
  1229. byte      1    Number of samples
  1230.   byte    1    Sample nr
  1231.   byte    1    Volume
  1232.   word    2    Samplelength in words
  1233.   char    20   Name of sample
  1234.   byte    1    Controlbyte bit 0=loop on/off
  1235.   byte    1    First 4 bits finetune 
  1236.   word    2    Repeat in words        ;Length to loop repeatpoint
  1237.   word    2    Replen in words        ;Length of loop
  1238.   long    4    Offset to the sample from the very beginning of the 
  1239.                file
  1240.  
  1241. byte      1    Pad
  1242. byte      1    Nr of patterns
  1243.   byte    1    Pattern nr
  1244.   byte    1    Length of pattern in rows - 1
  1245.   char    20   Name of pattern
  1246.   long    4    Offset to the pattern from the beginning of the file
  1247.  
  1248. byte      1    Pad
  1249. byte      1    Nr of positions
  1250.   byte    1    Patternnumber
  1251.  
  1252. byte      0 or 1 Extra byte to wordalign if necessary.
  1253.  
  1254.  
  1255. ******** Pattern data chunk **********
  1256.  
  1257. char      4    "PATT"                   ;Patterndata
  1258. long      4    Size of chunk
  1259. byte    16   row 1
  1260. byte 16   row 2
  1261. byte 16   row 3...
  1262.  
  1263.  
  1264. ******** Sample data chunk *********
  1265.  
  1266. char    4    "8SMP"              ;8 - bit SaMPle
  1267. long    4    Size of chunk
  1268. byte    ?    Sampledata
  1269.  
  1270.  
  1271. APPENDIX B  HISTORY
  1272. ===================
  1273.  
  1274. Version   Change
  1275. ----------------------------------------------------------------------
  1276. 2.0       * Everything
  1277. 2.01      * Fixed some bugs:
  1278.           * The Load Module Menu choise made the computer crash if you
  1279.             didn't have Magic Menu installed.
  1280.           * The Editskip keyboard shortcut did more than it should.
  1281. 2.011     * Eine kleine bug in the Synth fixed.
  1282.           * Op & Exit Echo does now work.
  1283.           * Warns if 'diskfont.library' isn't found.
  1284.           (About three lines in the source changed.)
  1285. 2.02      * Added "Pattern" to samplelist.
  1286. 2.021     * Fixed OS3.0 screenbar bug.
  1287. 2.03      * Made the menus look good on 3.0's. Unfortunately, they
  1288.             look like hell when using Magic Menu.
  1289.           * Noise in the synth addded.
  1290.           * The vibrato depth is now halved when loading/saving NT modules.
  1291.           * The graphics task doesn't freeze when closing the spect or scope window
  1292.             anymore (it used do to so sometimes).
  1293.           * The CIA / VBlank timing status is now saved in the pref file.
  1294.           * The keyboard buffer is cleared when playing sounds in the sample editor.
  1295.           * "Play"-time added.
  1296.           * The frequency of the vblank interrupt is now checked. The samplepointers 
  1297.             will be in the correct position all the time.
  1298.           * The envelopes in the synth are now save- and loadable.
  1299.           * Fixed a save NT module bug.
  1300.